home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: MegaDisc / MegaDisc 24 (1991-10)(MegaDisc Digital Publishing)(AU)(Disk 2 of 2).zip / MegaDisc 24 (1991-10)(MegaDisc Digital Publishing)(AU)(Disk 2 of 2).adf / FullView_doc / FullView_doc
Text File  |  1991-10-05  |  11KB  |  265 lines
  1.  
  2.                     --------------------------------------
  3.                     -           FullView v3.02           -
  4.                     -                                    -
  5.                     - (c) Copyright 1991 Jonathan Potter -
  6.                     --------------------------------------
  7.  
  8.                 -- See the bottom of this file for changes --
  9.  
  10.     FullView is a text viewer that offers fast, smooth-scrolling ANSI compatible text
  11. displays. This is now Megadisc's text viewer of choice and to get the most out of
  12. it, read through this doc, and check out the menus (with right mouse button).
  13.  
  14.     FullView opens up to the full size of the Workbench screen (non-interlaced).
  15. Because there is no slider gadget at the side of the screen, you are able to view full
  16. 80 column text with a standard Workbench configuration (many text viewers only show 78
  17. columns across).
  18.  
  19.     To start FullView from the CLI, simple type
  20.  
  21.         FullView filename
  22.  
  23.     or from the Workbench, double-click on a project icon that has FullView as its
  24. default tool.
  25.  
  26.     FullView will load text and pictures that have been crunched with PowerPacker, by
  27. Nico Francois.
  28.  
  29.     FullView has a built-in help screen that can instantly explain its functions, as
  30. well as remind you of the keyboard equivalent of many commands. However, here are brief
  31. instructions on the operation of the commands. They are listed with the command name
  32. (if this command is accessed from a menu, this is also the name of the menu item), and
  33. any keyboard equivalents the command may have.
  34.  
  35.         Load...            AMIGA-L or l key
  36.  
  37.         This command allows you to load a new text file using the built-in file
  38. requester. The file requester is similar to the Commodore ASL requester and to the ARP
  39. file requester, and thus most users should be familiar with its operation.
  40.  
  41.         Show Pic...        AMIGA-H or h key
  42.  
  43.         This command allows you to display an IFF ILBM picture file. A wide variety of
  44. formats is supported, including HAM, Overscan, EHB and Dynamic-HiRes.
  45.  
  46.         Save As...        AMIGA-V or v key
  47.  
  48.         This command allows you to save the currently displayed text file under a new
  49. name. This can also be useful for converting PowerPacker-crunched text into plain ASCII
  50. text.
  51.  
  52.         Print all        AMIGA-P or p key
  53.  
  54.         This command will print the current text file to the printer (PRT:).
  55.  
  56.         Print screen    AMIGA-C or c key
  57.  
  58.         This command will print the currently displayed page of text to the printer
  59. (PRT:).
  60.  
  61.         Search for...    AMIGA-S or s key
  62.  
  63.         This command allows you to search the current text file for a text string.
  64. Wildcard characters are not supported. The search takes place from the top of the
  65. currently displayed page.
  66.  
  67.         Repeat search    AMIGA-R or r key
  68.  
  69.         This command repeats the last text search, from the current position in the
  70. file.
  71.  
  72.         About
  73.  
  74.         This function displays some information about the program, including version
  75. number and how to contact the author.
  76.  
  77.         Help            HELP key
  78.  
  79.         This function displays a brief list of commands and their keyboard equivalents.
  80.  
  81.         Iconify            AMIGA-I or i key
  82.  
  83.         This command closes the FullView screen and opens a small window on the
  84. Workbench screen. This allows you to keep your text file in memory and refer to it at
  85. any time, but saves on memory when it is not actually being accessed. To return to the
  86. text file, click where the iconified window tells you to. Clicking the close gadget
  87. will remove the text file from memory without returning.
  88.  
  89.         Quit            AMIGA-Q or q, x, or ESCape key
  90.  
  91.         This command will remove FullView from memory.
  92.  
  93.         Auto scroll        SPACE bar or left mouse button
  94.  
  95.         FullView will auto-scroll text at four different speeds. The speed is
  96. determined by the vertical position of the mouse; the center of the screen is
  97. "neutral", and the further away from the center you move the mouse, the faster FullView
  98. will scroll in that direction.
  99.  
  100.         To toggle auto-scrolling, either press the SPACE bar or press the left mouse
  101. button. The mouse pointer will disappear while FullView is auto-scrolling, and reappear
  102. when scrolling stops (when you either stop it manually or the text reaches the top or
  103. bottom).
  104.  
  105.         Line up            Cursor up key or /\ gadget
  106.  
  107.         This function scrolls one line up through the text. If you continue to hold
  108. down the key or the gadget, this function will repeat after a brief interval.
  109.  
  110.         Line down        Cursor down key or \/ gadget
  111.  
  112.         This function scrolls one line down through the text. If you continue to hold
  113. down the key or the gadget, this function will repeat after a brief interval.
  114.  
  115.         Page up            Shift + Cursor up key, u key or U gadget
  116.  
  117.         This function moves one full page up through the text.
  118.  
  119.         Page down        Shift + Cursor down key, d key or D gadget
  120.  
  121.         This function moves one full page down through the text.
  122.  
  123.         Top of text        Control + Cursor up key, t key or T gadget
  124.  
  125.         This function moves to the beginning of the current text file.
  126.  
  127.         Bottom of text    Control + Cursor down key, b key or B gadget
  128.  
  129.         This function moves to the end of the current text file.
  130.  
  131.         Jump to line    j key or line gadget
  132.  
  133.         This function allows you to jump to a specified line number. The line gadget is
  134. the number that displays the current line being viewed in the status bar at the bottom
  135. of the screen (xxxxx > yyyyy; it is the xxxxx value)
  136.  
  137.         Jump to percent    J key or percent gadget
  138.  
  139.         This function allows you to jump a specified percentage into the file. This
  140. percent gadget is the number that displays the current percentage of text being viewed
  141. in the status bar (xxx%)
  142.  
  143.  
  144.     IFF routines
  145.  
  146.     FullView can show many different IFF ILBM formats, including HAM, Overscan, Extra
  147. Half Brite, and Dynamic-HiRes. There are four main ways to show an IFF picture with
  148. FullView.
  149.  
  150.         a) Run FullView with no arguments, and select an IFF picture with the
  151.            file requester.
  152.  
  153.         b) Once FullView has loaded a text file, select the Show Pic... command
  154.            and select an IFF picture with the file requester.
  155.  
  156.         c) Run FullView from the CLI with the name of an IFF picture and use the
  157.            +p argument.
  158.  
  159.            The +p tells FullView that it is a picture you want to show, not a
  160.            text file to read. The +p goes on the command line, after the filename.
  161.            For example,
  162.  
  163.                FullView dh0:Picture.iff +p
  164.  
  165.         d) From the Workbench, specify FullView as the default tool of a
  166.            picture file, and add the ToolType :
  167.  
  168.                FILETYPE=ILBM
  169.  
  170.            This has the same effect as the +p argument from the CLI.
  171.  
  172.     When a picture is displayed, there are several key presses that do different
  173. things. You can turn the mouse pointer on or off with the . key. You can stop/start
  174. colour cycling (if the file has colour cycling information) with the TAB key. Pressing
  175. the p key will print the picture. If a picture is larger than the screen, you can
  176. scroll around it using the cursor keys; by themselves they move in single steps, in
  177. conjunction with Shift they move a page, and in conjunction with Control they move to
  178. the start (or end). To return from a displayed picture, press the left mouse button, or
  179. the q or ESCape key.
  180.  
  181.  
  182.     TAB size
  183.  
  184.     The default size of tab characters in FullView is 4 spaces. You may, if running
  185. from the Workbench, specify the tab size yourself. To do this, add the following
  186. ToolType to the project icon :
  187.  
  188.         TABSIZE=size
  189.  
  190.     size is the number of spaces a tab character is to be equivalent to, and may be any
  191. number from 1 to 10.
  192.  
  193.  
  194.     ANSI codes
  195.  
  196.     FullView supports the ANSI codes used to change colour and type style. Because of
  197. the way FullView displays its text, there is a limitation on the changing of colour and
  198. type style; the colour and style is reset at the start of every line. This should not
  199. cause any major problems, but it does mean that if you wanted a rectangle of colour,
  200. you would have to specify the ANSI codes for every line, instead of just at the start
  201. and end of the rectangle. An example of this is the rectangular header of this document
  202. file.
  203.  
  204.     For your information, the applicable ANSI codes are :
  205.  
  206.         0    reset                        1    bold face
  207.         3    italic                        4    underscore
  208.         7    inverse video
  209.  
  210.         30    foreground pen colour 0        40    background pen colour 0
  211.         31    foreground pen colour 1        41    background pen colour 1
  212.         32    foreground pen colour 2        42    background pen colour 2
  213.         33    foreground pen colour 3        43    background pen colour 3
  214.  
  215.     ANSI codes are included in text using an escape code. This code looks like :
  216.  
  217.         <CSI>code[;code[;code]]m
  218.  
  219.     CSI is the Control Sequence Introducer, and it consists of an ESCape character and
  220. a [ character. For instance, to set the foreground colour to pen colour 2, the
  221. background colour to pen colour 3, and the style to italics and underscore, the control
  222. sequence would be :
  223.  
  224.         [[32;43;3;4m
  225.  
  226.         And here it is!!!
  227.  
  228.     You do not need to specify the [[0m reset sequence at the end of every line, as
  229. colours and styles are reset automatically for each line.
  230.  
  231.  
  232.     Word wrapping
  233.  
  234.     FullView will wrap-around to the next line any words that do not fit on the current
  235. line. This should normally not cause a problem. It could, however, cause trouble if
  236. FullView wraps words that are supposed to be a different colour and style. As colours
  237. and styles are reset for each line, any words that were wrapped would not be in the
  238. desired colour/style. There is no easy way out of this; all you can do is preview your
  239. text to make sure that this has not occurred. If it has, or you perceive it likely to
  240. happen, you can specify the escape code for each individual word. For instance,
  241.  
  242.         [[1mEach [[1mIndividual [[1mWord
  243.  
  244.  
  245.     Speaking of wrapping...
  246.  
  247.     That about wraps it up for this document file. FullView is largely
  248. self-explanatory, and I hope that I have covered all of the necessary points in this
  249. text. If you ever have trouble with FullView, please contact me at the address below.
  250.  
  251.     FullView is copyright, but is freely distributable. If you wish to use it in a
  252. commercial venture, however, you must contact me.
  253.  
  254.  
  255.                                Jonathan Potter
  256.                                  P.O. Box 289
  257.                               Goodwood, SA 5034
  258.                                   Australia
  259.  
  260.                              Phone : (08) 2932788
  261.                               Fax : (08) 2938941
  262.  
  263.                              FidoNET : 3:680/829
  264.                     Internet : jpotter@itd.adelaide.edu.au
  265.